IRIX 6.5 Complementary Applications 2004 February

home *** CD-ROM | disk | FTP | other *** search

/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmScreen.z / XmScreen

Wrap

Text File | 2003-11-18 | 23.1 KB | 397 lines

XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) NNNNAAAAMMMMEEEE _X_m_S_c_r_e_e_n - The Screen widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/Screen.h> DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The XmScreen object is used by Motif widgets to store information that is specific to a screen. It also allows the toolkit to store certain information on widget hierarchies that would otherwise be unavailable. Each client has one XmScreen object for each screen that it accesses. An XmScreen object is automatically created when the application creates the first shell on a screen (usually accomplished by a call to _X_t_A_p_p_I_n_i_t_i_a_l_i_z_e or _X_t_A_p_p_C_r_e_a_t_e_S_h_e_l_l). It is not necessary to create an XmScreen object by any other means. An application can use the function _X_m_G_e_t_X_m_S_c_r_e_e_n to obtain the widget ID of the XmScreen object for a given screen. An application cannot supply initial values for XmScreen resources as arguments to a call to any function that creates widgets. The application or user can supply initial values in a resource file. After creating the first shell on the screen, the application can use _X_m_G_e_t_X_m_S_c_r_e_e_n to obtain the widget ID of the XmScreen object and then call _X_t_S_e_t_V_a_l_u_e_s to set the XmScreen resources. CCCCllllaaaasssssssseeeessss Screen inherits behavior and resources from _C_o_r_e. The class pointer is _x_m_S_c_r_e_e_n_C_l_a_s_s. The class name is _X_m_S_c_r_e_e_n. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in an ._X_d_e_f_a_u_l_t_s file, remove the _X_m_N or _X_m_C prefix and use the remaining letters. To specify one of the defined values for a resource in an ._X_d_e_f_a_u_l_t_s file, remove the _X_m prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by using _X_t_G_e_t_V_a_l_u_e_s (G), or is not applicable (N/A). Page 1 (printed 11/11/03) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) XXXXmmmmSSSSccccrrrreeeeeeeennnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ________________________________________________________________________________________________________ XmNdarkThreshold XmCDarkThreshold int dynamic C XmNdefaultCopyCursorIcon XmCDefaultCopyCursorIcon Widget NULL CSG XmNdefaultInvalidCursorIcon XmCDefaultInvalidCursorIcon Widget NULL CSG XmNdefaultLinkCursorIcon XmCDefaultLinkCursorIcon Widget NULL CSG XmNdefaultMoveCursorIcon XmCDefaultMoveCursorIcon Widget NULL CSG XmNdefaultNoneCursorIcon XmCDefaultNoneCursorIcon Widget NULL CSG XmNdefaultSourceCursorIcon XmCDefaultSourceCursorIcon Widget NULL CSG XmNdefaultValidCursorIcon XmCDefaultValidCursorIcon Widget NULL CSG XmNfont XmCFont XFontStruct * NULL CSG XmNforegroundThreshold XmCForegroundThreshold int dynamic C XmNhorizontalFontUnit XmCHorizontalFontUnit int dynamic CSG XmNlightThreshold XmCLightThreshold int dynamic C XmNmenuCursor XmCCursor String arrow C XmNmoveOpaque XmCMoveOpaque Boolean False CSG XmNunpostBehavior XmCUnpostBehavior unsigned char XmUNPOST_AND_REPLAY CSG XmNverticalFontUnit XmCVerticalFontUnit int dynamic CSG _X_m_N_d_a_r_k_T_h_r_e_s_h_o_l_d An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived brightness of the background color is below this level, Motif treats the background as "dark" when computing default shadow and select colors. If this resource is specified for a particular screen, it applies to widgets created on that screen; otherwise it applies to widgets created on all screens. The default value is implementation specific. Specifies the DragIcon used during a drag operation when the operation is a copy and no other pixmap is specified by the application. If NULL, a system default icon is used. The system default icon is determined by the XmDisplay resource _e_n_a_b_l_e_D_r_a_g_I_c_o_n. _X_m_N_d_e_f_a_u_l_t_I_n_v_a_l_i_d_C_u_r_s_o_r_I_c_o_n Specifies the DragIcon used to indicate that the cursor is over an invalid drop site during a drag operation when no other pixmap symbol is specified by the application. If NULL, a system default icon is used. The system default icon is determined by the XmDisplay resource _e_n_a_b_l_e_D_r_a_g_I_c_o_n. _X_m_N_d_e_f_a_u_l_t_L_i_n_k_C_u_r_s_o_r_I_c_o_n Specifies the DragIcon used during a drag operation when the operation is a link and no other pixmap is specified by the application. If NULL, a system default icon is used. The system default icon is determined by the XmDisplay resource _e_n_a_b_l_e_D_r_a_g_I_c_o_n. Page 2 (printed 11/11/03) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) _X_m_N_d_e_f_a_u_l_t_M_o_v_e_C_u_r_s_o_r_I_c_o_n Specifies the DragIcon used during a drag operation when the operation is a move and no other pixmap is specified by the application. If NULL, a system default icon is used. The system default icon is determined by the XmDisplay resource _e_n_a_b_l_e_D_r_a_g_I_c_o_n. _X_m_N_d_e_f_a_u_l_t_N_o_n_e_C_u_r_s_o_r_I_c_o_n Specifies the DragIcon used to indicate that the cursor is not over a drop site during a drag operation when no other pixmap is specified by the application. If NULL, a system default icon is used. The system default icon is determined by the XmDisplay resource _e_n_a_b_l_e_D_r_a_g_I_c_o_n. _X_m_N_d_e_f_a_u_l_t_S_o_u_r_c_e_C_u_r_s_o_r_I_c_o_n Specifies the depth-1 pixmap used as a cursor when an _X_m_N_s_o_u_r_c_e_C_u_r_s_o_r_I_c_o_n is not provided by the DragContext, or it is not usable. If NULL, a system default icon is used. The system default icon is determined by the XmDisplay resource _e_n_a_b_l_e_D_r_a_g_I_c_o_n. _X_m_N_d_e_f_a_u_l_t_V_a_l_i_d_C_u_r_s_o_r_I_c_o_n Specifies the DragIcon used to indicate that the cursor is over a valid drop site during a drag operation when no other pixmap is specified by the application. If NULL, a system default icon is used. The system default icon is determined by the XmDisplay resource _e_n_a_b_l_e_D_r_a_g_I_c_o_n. _X_m_N_f_o_n_t Specifies a font for use in computing values for _X_m_N_h_o_r_i_z_o_n_t_a_l_F_o_n_t_U_n_i_t and _X_m_N_v_e_r_t_i_c_a_l_F_o_n_t_U_n_i_t. When an application is initialized, this resource can be supplied in a resource file or through the standard command line options -_f_n, -_f_o_n_t, and -_x_r_m. _X_m_N_f_o_r_e_g_r_o_u_n_d_T_h_r_e_s_h_o_l_d An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived brightness of the background color is equal to or below this level, Motif treats the background as "dark" when computing the default foreground and highlight colors. If the perceived brightness of the background color is above this level, Motif treats the background as "light" when computing the default foreground and highlight colors. When the background is "dark", the default foreground and highlight is white; when the background is "light", the default foreground and highlight is black. If this resource is specified for a particular screen, it applies to widgets created on that screen; otherwise, it applies to widgets created on all screens. The default value Page 3 (printed 11/11/03) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) is implementation specific. _X_m_N_h_o_r_i_z_o_n_t_a_l_F_o_n_t_U_n_i_t Specifies the horizontal component of the font units used by _X_m_C_o_n_v_e_r_t_U_n_i_t_s, and is used to interpret the values of geometry resources when the _X_m_N_s_h_e_l_l_U_n_i_t_T_y_p_e resource of VendorShell or the _X_m_N_u_n_i_t_T_y_p_e resource of Gadget, Manager, or Primitive has the value _X_m_1_0_0_T_H__F_O_N_T__U_N_I_T_S. If no initial value is supplied for this resource, the default is computed from the font specified in _X_m_N_f_o_n_t. If no initial value is supplied for this resource or for _X_m_N_f_o_n_t, the default is 10. If a call to _X_t_S_e_t_V_a_l_u_e_s specifies a value for _X_m_N_h_o_r_i_z_o_n_t_a_l_F_o_n_t_U_n_i_t, this resource is set to that value. If a call to _X_t_S_e_t_V_a_l_u_e_s specifies a value for _X_m_N_f_o_n_t but not for _X_m_N_h_o_r_i_z_o_n_t_a_l_F_o_n_t_U_n_i_t, this resource is set to a value computed from the new _X_m_N_f_o_n_t. A horizontal font unit is derived from a font as follows: +o If the font has an _A_V_E_R_A_G_E__W_I_D_T_H property, the horizontal font unit is the _A_V_E_R_A_G_E__W_I_D_T_H property divided by 10. +o If the font has no _A_V_E_R_A_G_E__W_I_D_T_H property but has a _Q_U_A_D__W_I_D_T_H property, the horizontal font unit is the _Q_U_A_D__W_I_D_T_H property. +o If the font has no _A_V_E_R_A_G_E__W_I_D_T_H or _Q_U_A_D__W_I_D_T_H property, the horizontal font unit is the sum of the font structure's mmmmiiiinnnn____bbbboooouuuunnnnddddssss....wwwwiiiiddddtttthhhh and mmmmaaaaxxxx____bbbboooouuuunnnnddddssss....wwwwiiiiddddtttthhhh divided by 2.3. _X_m_N_l_i_g_h_t_T_h_r_e_s_h_o_l_d An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived brightness of the background color is above this level, Motif treats the background as "light" when computing default shadow and select colors. If this resource is specified for a particular screen, it applies to widgets created on that screen; otherwise, it applies to widgets created on all screens. The default value is implementation specific. _X_m_N_m_e_n_u_C_u_r_s_o_r Sets a variable that controls the cursor used whenever this application posts a menu. This resource can be specified only once at application startup time, either Page 4 (printed 11/11/03) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) by placing it within a defaults file or by using the -_x_r_m command line argument. For example myProg -xrm "*menuCursor: arrow" The menu cursor can also be selected in the program through the function _X_m_S_e_t_M_e_n_u_C_u_r_s_o_r. The following is a list of acceptable cursor names. If the application does not specify a cursor or if an invalid name is supplied, the default cursor (an arrow pointing up and to the right) is used. XXXX____ccccuuuurrrrssssoooorrrr ddddoooottttbbbbooooxxxx mmmmaaaannnn ssssiiiizzzziiiinnnngggg aaaarrrrrrrroooowwww ddddoooouuuubbbblllleeee____aaaarrrrrrrroooowwww mmmmiiiiddddddddlllleeeebbbbuuuuttttttttoooonnnn ssssppppiiiiddddeeeerrrr bbbbaaaasssseeeedddd____aaaarrrrrrrroooowwww____ddddoooowwwwnnnn ddddrrrraaaafffftttt____llllaaaarrrrggggeeee mmmmoooouuuusssseeee sssspppprrrraaaayyyyccccaaaannnn bbbbaaaasssseeeedddd____aaaarrrrrrrroooowwww____uuuupppp ddddrrrraaaafffftttt____ssssmmmmaaaallllllll ppppeeeennnncccciiiillll ssssttttaaaarrrr bbbbooooaaaatttt ddddrrrraaaappppeeeedddd____bbbbooooxxxx ppppiiiirrrraaaatttteeee ttttaaaarrrrggggeeeetttt bbbbooooggggoooossssiiiittttyyyy eeeexxxxcccchhhhaaaannnnggggeeee pppplllluuuussss ttttccccrrrroooossssssss bbbboooottttttttoooommmm____lllleeeefffftttt____ccccoooorrrrnnnneeeerrrr fffflllleeeeuuuurrrr qqqquuuueeeessssttttiiiioooonnnn____aaaarrrrrrrroooowwww ttttoooopppp____lllleeeefffftttt____aaaarrrrrrrroooowwww bbbboooottttttttoooommmm____rrrriiiigggghhhhtttt____ccccoooorrrrnnnneeeerrrr ggggoooobbbbbbbblllleeeerrrr rrrriiiigggghhhhtttt____ppppttttrrrr ttttoooopppp____lllleeeefffftttt____ccccoooorrrrnnnneeeerrrr bbbboooottttttttoooommmm____ssssiiiiddddeeee gggguuuummmmbbbbyyyy rrrriiiigggghhhhtttt____ssssiiiiddddeeee ttttoooopppp____rrrriiiigggghhhhtttt____ccccoooorrrrnnnneeeerrrr bbbboooottttttttoooommmm____tttteeeeeeee hhhhaaaannnndddd1111 rrrriiiigggghhhhtttt____tttteeeeeeee ttttoooopppp____ssssiiiiddddeeee bbbbooooxxxx____ssssppppiiiirrrraaaallll hhhhaaaannnndddd2222 rrrriiiigggghhhhttttbbbbuuuuttttttttoooonnnn ttttoooopppp____tttteeeeeeee cccceeeennnntttteeeerrrr____ppppttttrrrr hhhheeeeaaaarrrrtttt rrrrttttllll____llllooooggggoooo ttttrrrreeeekkkk cccciiiirrrrcccclllleeee iiiiccccoooonnnn ssssaaaaiiiillllbbbbooooaaaatttt uuuullll____aaaannnngggglllleeee cccclllloooocccckkkk iiiirrrroooonnnn____ccccrrrroooossssssss ssssbbbb____ddddoooowwwwnnnn____aaaarrrrrrrroooowwww uuuummmmbbbbrrrreeeellllllllaaaa ccccooooffffffffeeeeeeee____mmmmuuuugggg lllleeeefffftttt____ppppttttrrrr ssssbbbb____hhhh____ddddoooouuuubbbblllleeee____aaaarrrrrrrroooowwww uuuurrrr____aaaannnngggglllleeee ccccrrrroooossssssss lllleeeefffftttt____ssssiiiiddddeeee ssssbbbb____lllleeeefffftttt____aaaarrrrrrrroooowwww wwwwaaaattttcccchhhh ccccrrrroooossssssss____rrrreeeevvvveeeerrrrsssseeee lllleeeefffftttt____tttteeeeeeee ssssbbbb____rrrriiiigggghhhhtttt____aaaarrrrrrrroooowwww xxxxtttteeeerrrrmmmm ccccrrrroooosssssssshhhhaaaaiiiirrrr lllleeeeffffttttbbbbuuuuttttttttoooonnnn ssssbbbb____uuuupppp____aaaarrrrrrrroooowwww ddddiiiiaaaammmmoooonnnndddd____ccccrrrroooossssssss llllllll____aaaannnngggglllleeee ssssbbbb____vvvv____ddddoooouuuubbbblllleeee____aaaarrrrrrrroooowwww ddddooootttt llllrrrr____aaaannnngggglllleeee sssshhhhuuuuttttttttlllleeee _X_m_N_m_o_v_e_O_p_a_q_u_e Specifies whether an interactive operation that moves a window, such as tearing off and dragging a tear-off menu or moving a window in MWM, displays an outline of the window or a representation of the window itself during the move. If the value is True, the operation displays a representation of the window during the move. If the value is False, the operation displays an outline of the window. _X_m_N_u_n_p_o_s_t_B_e_h_a_v_i_o_r Specifies the behavior of an active menu posted in traversal mode when a subsequent menu button selection is made outside the posted menu. When the value is _X_m_U_N_P_O_S_T__A_N_D__R_E_P_L_A_Y, the resource unposts the menu hierarchy and causes the server to replay the event to the window in which the pointer is located. When the Page 5 (printed 11/11/03) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) value is _X_m_U_N_P_O_S_T, the resource unposts the hierarchy without replaying the event. _X_m_N_v_e_r_t_i_c_a_l_F_o_n_t_U_n_i_t Specifies the vertical component of the font units used by _X_m_C_o_n_v_e_r_t_U_n_i_t_s and used to interpret the values of geometry resources when the _X_m_N_s_h_e_l_l_U_n_i_t_T_y_p_e resource of VendorShell or the _X_m_N_u_n_i_t_T_y_p_e resource of Gadget, Manager, or Primitive has the value _X_m_1_0_0_T_H__F_O_N_T__U_N_I_T_S. If no initial value is supplied for this resource, the default is computed from the font specified in _X_m_N_f_o_n_t. If no initial value is supplied for this resource or for _X_m_N_f_o_n_t, the default is 10. If a call to _X_t_S_e_t_V_a_l_u_e_s specifies a value for _X_m_N_v_e_r_t_i_c_a_l_F_o_n_t_U_n_i_t, this resource is set to that value. If a call to _X_t_S_e_t_V_a_l_u_e_s specifies a value for _X_m_N_f_o_n_t but not for _X_m_N_v_e_r_t_i_c_a_l_F_o_n_t_U_n_i_t, this resource is set to a value computed from the new _X_m_N_f_o_n_t. A vertical font unit is derived from a font as follows: +o If the font has a _P_I_X_E_L__S_I_Z_E property, the vertical font unit is the _P_I_X_E_L__S_I_Z_E property divided by 1.8. +o If the font has no _P_I_X_E_L__S_I_Z_E property but has _P_O_I_N_T__S_I_Z_E and _R_E_S_O_L_U_T_I_O_N__Y properties, the vertical font unit is the product of the _P_O_I_N_T__S_I_Z_E and _R_E_S_O_L_U_T_I_O_N__Y properties divided by 1400. +o If the font has no _P_I_X_E_L__S_I_Z_E, _P_O_I_N_T__S_I_Z_E, or _R_E_S_O_L_U_T_I_O_N__Y properties, the vertical font unit is the sum of the font structure's mmmmaaaaxxxx____bbbboooouuuunnnnddddssss....aaaasssscccceeeennnntttt and mmmmaaaaxxxx____bbbboooouuuunnnnddddssss....ddddeeeesssscccceeeennnntttt divided by 2.2. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss All of the superclass resources inherited by XmScreen are designated N/A (not applicable). RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN _C_o_r_e(_3_X), _X_m_D_i_s_p_l_a_y(_3_X), and _X_m_G_e_t_X_m_S_c_r_e_e_n(_3_X). Page 6 (printed 11/11/03)